Tiktok Followers Api Scraper

Scrape follower lists for TikTok profiles. Uses Playwright to load profile pages, open the followers modal, and collect follower data. Output matches the structure of TikTok's follower API (authorMeta, connectedTo, connectionType, connectionDescription).

Why use this Actor?

• Bulk URLs: Enter multiple profile URLs or usernames in one run.
• Proxy fallback: Runs with no proxy by default; automatically falls back to datacenter then residential proxy if TikTok blocks requests. Sticks with residential for remaining profiles after fallback.
• Structured output: Each follower includes full author and connected-to profile info (id, name, profileUrl, nickName, verified, signature, stats, etc.).

Input

Field	Type	Required	Description
startUrls	array	Yes	TikTok profile URLs (e.g. https://www.tiktok.com/@nike) or usernames (e.g. nike). Supports bulk.
proxyConfiguration	object	Yes	Proxy settings. Default no proxy; actor falls back to datacenter/residential if blocked.
maxFollowersPerProfile	integer	No	Max followers to collect per profile (default: 100, max: 5000).
sid_tt	string	No	Optional TikTok session cookie for better access.

Example input (JSON):

{
  "startUrls": [
    { "url": "https://www.tiktok.com/@nike" },
    { "url": "khaby.lame" }
  ],
  "proxyConfiguration": { "useApifyProxy": false },
  "maxFollowersPerProfile": 100,
  "sid_tt": ""
}

Output

Each follower is saved to the dataset in real time the moment it is captured (no waiting until the end of the run). Every item contains both flat table-friendly fields and the full nested objects.

Flat fields (used by the Followers table view):

• sourceProfile: username of the profile whose followers were scraped
• followerUsername, followerNickname, followerProfileUrl
• followerVerified, followerFans, followerFollowing, followerVideos, followerHearts
• followerAvatar, followerSignature, followerPrivate

Nested objects (used by the Full Data view):

• authorMeta: follower user (id, name, profileUrl, nickName, verified, signature, avatar, stats: following, friends, fans, heart, video, digg, etc.)
• connectedTo: profile that was scraped (same structure)
• connectionType: "following"
• connectionDescription: e.g. "khaby.lame is following arnaldomangini"

The dataset is exposed through three tabs/views (sections):

1. Followers — one row per follower with key stats (default view).
2. Connection Details — source profile, follower, connection type/description, and the connected-to profile.
3. Full Data — the complete nested authorMeta and connectedTo objects for downstream API use.

Export the dataset as JSON and group by sourceProfile to get a single object keyed by profile with arrays of followers.

How to use (Apify Console)

1. Open Apify Console and go to Actors.
2. Find tiktok-followers-api-scraper and open it.
3. Under Input, add TikTok profile URLs or usernames in URLs or usernames (bulk). Set Limit and Proxy configuration if needed.
4. Click Start.
5. Watch Log for progress; open Output (dataset) when the run finishes.
6. Export results as JSON or CSV.

Cautions

• Data is from public profiles only. No private or password-protected content.
• You are responsible for compliance with TikTok’s terms and applicable laws (privacy, data protection, etc.).